package com.greentravel.dao;

import com.greentravel.model.User;
import java.util.List;

/**
 * 用户数据访问对象接口
 * 定义对用户数据的操作方法
 */
public interface UserDAO {

    /**
     * 添加用户
     * 
     * @param user 用户对象
     * @return 是否添加成功
     */
    boolean addUser(User user);

    /**
     * 根据用户ID删除用户
     * 
     * @param id 用户ID
     * @return 是否删除成功
     */
    boolean deleteUser(int id);

    /**
     * 更新用户信息
     * 
     * @param user 用户对象
     * @return 是否更新成功
     */
    boolean updateUser(User user);

    /**
     * 根据用户ID查询用户
     * 
     * @param id 用户ID
     * @return 用户对象
     */
    User getUserById(int id);

    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return 用户对象
     */
    User getUserByUsername(String username);

    /**
     * 查询所有用户
     * 
     * @return 用户列表
     */
    List<User> getAllUsers();

    /**
     * 用户登录验证
     * 
     * @param username 用户名
     * @param password 密码
     * @return 用户对象，如果验证失败返回null
     */
    User login(String username, String password);

    /**
     * 验证用户名是否已存在
     * 
     * @param username 用户名
     * @return 是否存在
     */
    boolean isUsernameExist(String username);

    /**
     * 更新用户积分
     * 
     * @param userId 用户ID
     * @param points 增加的积分
     * @return 是否更新成功
     */
    boolean updateUserPoints(int userId, int points);

    /**
     * 根据积分排序获取用户列表
     * 
     * @return 排序后的用户列表
     */
    List<User> getUsersOrderByPoints();
}